[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 WARNING: This document is subject to change at any time.  Any changes made
 will be indicated by a vertical bar (|) in column 1 of the file.
|Last update: 04/02/93  (the vertical bar currently indicates NEW FOR v15.0)
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

 The following information documents the format for PCBoard's USERS file
 and index files format.

 Each user record is 400 bytes in length.  There are no headers or other
 special considerations contained within the users file.  Therefore, a
 users file with 4 user records would be 1600 bytes in length.

 The following layout is specified in a "byte offset" format such that the
 first field begins at offset 0.

 The following is a definition of the variable types that will be used:

   int    = a 2 byte value used to form an unsigned integer word
   long   = a 4 byte value used to form a long integer
   char   = a 1 byte character
   str    = an array of 2 or more "char" bytes
   bsreal = a 4 byte Basic Single Precision real number
   bdreal = an 8 byte Basic Double Precision real number
   bitmap = 1 or more bytes used to store bit flags

 Note that strings are not NULL terminated and that the length specified for
 the string is full number of useable and storeable bytes.  All strings are
 padded with spaces to fill the entire field.

 USERS FILE
 ==========

   Offset   Type   Length  Description
   ------  ------  ------  -----------
      0    str       25    Full Name
     25    str       24    City
     49    str       12    Password
     61    str       13    Business / Data Phone Number
     74    str       13    Home / Voice Phone Number
     87    str        6    Last Date On (format:  YYMMDD)
     93    str        5    Last Time On (format HH:MM)
     98    char       1    Expert Mode (Y or N)
     99    char       1    Default Transfer Protocol (A-Z, 0-9)
    100    bitmap     1    Bit Flags (see below)
    101    str        6    Date of Last DIR Scan (most recent file found)
    107    char       1    Security Level (0-255)
    108    int        2    Number of Times On
    110    char       1    Page Length (# lines displayed before prompt)
    111    int        2    Number of Files Uploaded
    113    int        2    Number of Files Downloaded
    115    bdreal     8    Total Bytes Downloaded Today
    123    str       30    Comment Field #1 (user comment)
    153    str       30    Comment Field #2 (sysop comment - user can't see)
    183    int        2    Elapsed Time On (in minutes)
    185    str        6    Registration Expiration Date (YYMMDD)
    191    char       1    Expired Registration - Security Level
    192    char       1    Last Conference In (used for v14.x compatibility)
    193    bitmap     5    Conference Registration Flags (conf 0-39)
    198    bitmap     5    Expired Registration Conference Flags (conf 0-39)
    203    bitmap     5    User Selected Conference Flags (conf 0-39)
    208    bdreal     8    Total Bytes Downloaded
    216    bdreal     8    Total Bytes Uploaded
    224    char       1    Delete Flag (Y or N)
    225    bsreal     4    Last Message Read pointer (conference 0)
    229    bsreal     4    Last Message Read pointer (conference 1)
    ...    bsreal     4    (continued each conference)
    381    bsreal     4    Last Message Read pointer (conference 39)
    385    long       4    Record Number of USERS.INF Record
|   389    bitmap     1    Bit Flags 2 (see below)
    390    str        8    Reserved (do not use)
    398    int        2    Last Conference In (used instead of offset 192)


 Bit Flags
 ---------
 The bit flags are used to store the status of several flags using only a
 single byte to store them.  They are stored in the following order:

 Bit 0 = Dirty Flag (used to indicate another process updated the record)
 Bit 1 = Clear Screen Between Messages
 Bit 2 = Has Mail Flag
 Bit 3 = Don't Ask for Full Screen Editor Use
 Bit 4 = Full Screen Editor Default
|Bit 5 = Scroll Message Body
|Bit 6 = Use Short Message Headers
|Bit 7 = Use Wide (79-column) Editor

|Bit Flags 2
|-----------
|The bit flags are used to store the status of several flags using only a
|single byte to store them.  They are stored in the following order:
|
|Bit 0 = Chat Status - OFF=Available, ON=unavailable
|Bit 1 = reserved
|Bit 2 = reserved
|Bit 3 = reserved
|Bit 4 = reserved
|Bit 5 = reserved
|Bit 6 = reserved
|Bit 7 = reserved

 USER INDEX FILES
 ================

   Offset   Type   Length  Description
   ------  ------  ------  -----------
      0    int        2    Record Number in USERS File
      2    str       25    Full Name

 There are 26 separate index files for the users.  They are separated into
 PCNDX.A thru PCBNDX.Z storing names beginning with the letters "A" thru "Z"
 respectively.  Names starting with character before ascii "A" are stored in
 the PCBNDX.A file and similarly names starting with characters after ascii
 "A" are stored in the PCBNDX.Z file.

This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson